home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / tvagentt.zip / TVDOOR.ZIP / TVDOOR.DOC < prev    next >
Text File  |  1996-01-19  |  6KB  |  144 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                  TVDOOR
  10.  
  11.        An automated delivery system for Lee Bonnifields' TVAGENT
  12.                        and Planet Connect systems
  13.  
  14.  
  15.                             By Pab Sungenis
  16.                         Copr. 1996 Pab Sungenis
  17.  
  18.  
  19.                        Another Shareware Offering
  20.  
  21.  
  22.  
  23.                               ------------
  24.                               INTRODUCTION
  25.                               ------------
  26.  
  27.         When I finally got around to checking out the TVAGENT program
  28. that came along with my Planet Connect membership, I was thrilled.  I
  29. found the program simple, useful, and powerful.  Eventually, I signed up
  30. as a distribution site for TVAGENT and made the listings available to my
  31. users.
  32.  
  33.         But there were a few catches.  First, I had to jump through
  34. several hoops to move the files into my download areas, and then my
  35. users had to manually scan through the file listings to look for which
  36. files had been updated, which had expired, which were new arrivals, and
  37. so on.  It became more trouble than it was worth.
  38.  
  39.         My solution lies here before you.  This door will keep track of
  40. when your users last used it to download updated listings, and will
  41. automatically queue up new or updated listing files for them to
  42. download.  Plus, you no longer need to import the listings into your
  43. board or extract the TVLISTTK files.  It all becomes simple and
  44. automatic.
  45.  
  46.  
  47.                              -------------
  48.                              SETTING IT UP
  49.                              -------------
  50.  
  51.         First off, you'll need a Planet Connect setup to make use of
  52. this door.  If you don't have one, I don't know how you got this file,
  53. but you might as well delete it now.
  54.  
  55.         You'll also need:
  56.  
  57.                 * A BBS capable of creating a DOOR.SYS file, or a
  58.                   utility to convert your BBS's drop file to DOOR.SYS.
  59.  
  60.                 * A version of DSZ, GSZ, or another protocol engine
  61.                   capable of XModem, YModem and ZModem transfers.
  62.  
  63.         The odds are you already have both, or have easy access to them.
  64.  
  65.         To configure TVDOOR, you can either place the program in your
  66. BBS directory or its own directory.  If you place it in its own
  67. directory, be sure to use a batch file to change to that directory
  68. before running the door so it can find its configuration files.
  69.  
  70.         You should either extract or copy the following files to the
  71. TVDOOR directory:
  72.  
  73.                 TVDOOR.EXE      This is the main door program
  74.                 TVDOOR.CFG      The configration file, you will be
  75.                                 editing this shortly.
  76.                 TVNEWUSE.*      These are text files giving a short intro
  77.                                 to TVAGENT, and explaining the door.
  78.                                 Feel free to edit these however you see
  79.                                 fit.
  80.  
  81.         Next, using a text editor, edit the TVDOOR.CFG file to match
  82. your system configuration.  The lines of the configuration file are as
  83. follows:
  84.  
  85.         (1) The path to your TVLIST*.ARC files
  86.         (2) The filemask for listing files.  This will probably be
  87.             TVLIST*.ARC for quite some time, but was left as
  88.             configurable in case Lee changes his mind at some time.
  89.         (3) The directory to copy to on local 'downloads.'  Chances are
  90.             this will be the same directory as your own TVAGENT
  91.             directory.
  92.         (4) The command line to send a file using XModem.  Chances are
  93.             you will only need to change the path to the TVDOOR.BEW file
  94.             (which the door will create as needed).  If you use an
  95.             engine other than DSZ/GSZ, change this line accordingly.
  96.             The *P macro will expand to the port number, and the *B
  97.             macro will expand to the current baud rate.
  98.         (5) The command line to send files with YModem.
  99.         (6) The command line to send files with ZModem.
  100.         (7) The path and filename for the TVADEMO program.  This
  101.             will probably be TVADEMO.ZIP in your SKYDATA\PERSONAL
  102.             directory.
  103.  
  104.  
  105.                                ----------
  106.                                RUNNING IT
  107.                                ----------
  108.  
  109.         Once the TVDOOR.CFG file is all set up for your system, you're
  110. ready to run the program.  To run the program, use the command line:
  111.  
  112.                 TVDOOR [dir]
  113.  
  114. where [dir] is the directory to search for the DOOR.SYS file created by
  115. your BBS.  Everything else follows through automatically.
  116.  
  117.         TVDOOR also works in local mode.  When you run it locally, the
  118. door will copy the updated listings to your TVAGENT directory, as
  119. configured in TVDOOR.CFG.
  120.  
  121.         That's all there is to it.  Really.  Nothing more.
  122.  
  123.  
  124.                                ----------
  125.                                CONCLUSION
  126.                                ----------
  127.  
  128.         Like many of my programs, I ended up writing TVDOOR to solve my
  129. own problems.  It is fully functional and not crippled in any way.
  130.  
  131.         If you find the program useful, I do request that you send a
  132. $10.00 donation, but do not require it.  Should you want to show your
  133. gratitude appropriately, please send all donations to:
  134.  
  135.                 Pab Sungenis
  136.                 1349 Roosevelt Blvd.
  137.                 Vineland, NJ  08360-6590
  138.  
  139.         If you have any questions, feel free to E-Mail me at pab@cnx.com
  140. or Netmail me at 1:266/73.  I also frequent the PCSITES echo.
  141.  
  142.                                                 Pab Sungenis
  143.                                                 1-19-96
  144.